# Ethernet interface

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

The **Quectel Pi H1** Smart Single-Board Computer comes with one standard `RJ45` port, supporting Ethernet communication speeds of 10/100/1000 Mbps.

```{note}
Ethernet cable requirement: only straight-through cables are supported; crossover cables are not supported.
```

# **Hardware interface**

```{image} images/image_CDDibsLsooLCQExPMrncSEEunZb.webp
:width: 609px
:height: 316px
```

# Basic functionality

## View network configuration

The system enables the **NetworkManager** service by default to manage network connections.

1.In the terminal, enter the command `sudo ifconfig` to view the network interface address:

```plaintext
sudo ifconfig
```

Output example: The `10.55.62.236` following `inet addr:` is the local IP address.

```{image} images/image_XfxQbZGtsohGZ4xf8CFcFN8insb.webp
:width: 598px
:height: 401px
```

2.In the terminal, enter the command `sudo route -n` to view the network routing information.

```plaintext
sudo route -n
```

Output example:

```{image} images/image_Be6NbzTNKoTlTTxUzw7cjzpnnGe.webp
:width: 653px
:height: 121px
```

3.View the contents of the **`/etc/resolv.conf`** file to verify the **DNS** server address:

```plaintext
cat /etc/resolv.conf
```

Output example:

```{image} images/image_V5drbkgWFomHVpxdkZycvi3cnkb.webp
:width: 700px
:height: 371px
```

## Automatic network configuration acquisition

The system is set to automatically acquire network configuration. When a device is connected to the local area network using an Ethernet cable, it will automatically acquire network configuration.

> **Prerequisite:** A **DHCP** service must be available in the local area network.

**Troubleshooting**

❗Note：If you modify the network configuration through a remote connection, there is a risk of losing network access. Please ensure you have an alternative method (such as a debug serial port or display) to view the modified network configuration.

1.View the connection information by running the command `nmcli c` in the terminal.

```plaintext
nmcli c
```

Output example:

```{image} images/image_B71pbLuLto75zpxtUVacJQW0nAc.webp
:width: 675px
:height: 76px
```

Observe whether the **DEVICE** column in the output contains **eth0**. If it does, delete it and recreate **eth0**.

2.To delete the old connection information, enter the following command in the terminal:

```plaintext
nmcli c del 'XXXX'
```

`XXXX` represents the **NAME** acquired from the `nmcli c` query.

After successful deletion, a connection with **NAME** set to **eth0** will be automatically created by default. Replug the Ethernet cable, and the device will automatically acquire the network configuration.

## Manual network configuration

1.View the connection information by running `nmcli c` in the terminal.

Observe whether the **DEVICE** column in the output contains **eth0**, and note its **NAME**.

If **eth0** is not listed, create a new **eth0** connection by running the following command in the terminal:

```plaintext
nmcli c add type ethernet con-name 'Wired connection 1' ifname eth0
```

2.For manual configuration, execute the following command in the terminal:

```plaintext
nmcli c modify 'Wired connection 1' \
ipv4.addresses 192.168.1.100/24 \
ipv4.gateway 192.168.1.1 \
ipv4.dns 192.168.1.1 \
ipv4.method manual
```

3.Enable the connection (modify the **IP** address, gateway address, and **DNS** address in the example as needed).

```plaintext
nmcli c up 'Wired connection 1'
```

# Test the network

**Run the`ping`****command to test network connectivity**

- Run `ping 8.8.8.8`. If the **ping** is successful, it indicates that the external network connection is working properly.

- Run `ping www.google.com`. If the **ping** is successful, it indicates that the external network connection is working properly and the **DNS** resolution function is working correctly.